home *** CD-ROM | disk | FTP | other *** search
/ Aminet 43 / Aminet 43 (2001)(GTI - Schatztruhe)[!][Jun 2001].iso / Aminet / util / boot / PatchRAM.readme < prev    next >
Text File  |  2001-05-03  |  8KB  |  231 lines
  1. Short:    Patch Os 3.9 RAM-Handler to show right size
  2. Author:   thor@einstein.math.tu-berlin.de (Thomas Richter)
  3. Uploader: thor@einstein.math.tu-berlin.de (Thomas Richter)
  4. Version:  2.00
  5. Type:     util/boot
  6. Requires: Os 3.9, Ram-Handler 44.21
  7.  
  8. This file patches the RAM disk to show the real size occupied - its no longer
  9. 100% full. Furthermore, it increments the stack size of the RAM task a bit,
  10. which seems to be *very tight*.
  11. ____________________________________________________________________________
  12.  
  13. Changes made in 2.00:
  14.  
  15. Completely new and different implementation for the Os 3.9 RAM-Handler,
  16. PatchRAM is now a permanent patch for RAM that comes in the form of a
  17. patch-file.
  18.  
  19. ____________________________________________________________________________
  20.  
  21.                         The THOR-Software Licence
  22.  
  23.  
  24. This License applies to the computer programs known as "PatchRAM".
  25. The "Program", below, refers to such program.
  26.  
  27.  
  28. The programs and files in this distribution are freely distributable
  29. under the restrictions stated below, but are also Copyright (c)
  30. Thomas Richter.
  31.  
  32.  
  33. Distribution of the Program by a commercial organization without written
  34. permission from the author to any third party is prohibited if any payment
  35. is made in connection with such distribution, whether directly
  36. (as in payment for a copy of the Program) or indirectly (as in payment
  37. for some service related to the Program, or payment for some product
  38. or service that includes a copy of the Program "without charge";
  39. these are only examples, and not an exhaustive enumeration of prohibited
  40. activities). However, the following methods of distribution involving
  41. payment shall not in and of themselves be a violation of this restriction:
  42.  
  43.  
  44. (i) Posting the Program on a public access information storage and
  45. retrieval service for which a fee is received for retrieving information
  46. (such as an on-line service), provided that the fee is not
  47. content-dependent (i.e., the fee would be the same for retrieving the same
  48. volume of information consisting of random data).
  49.  
  50.  
  51.  
  52. (ii) Distributing the Program on a CD-ROM, provided that the files
  53. containing the Program are reproduced entirely and verbatim on such
  54. CD-ROM, and provided further that all information on such CD-ROM be
  55. redistributable for non-commercial purposes without charge.
  56.  
  57.  
  58.  
  59. Everything in this distribution must be kept together, in original
  60. and unmodified form.
  61.  
  62.  
  63.  
  64.  
  65. Limitations.
  66.  
  67. THE PROGRAM IS PROVIDED TO YOU "AS IS," WITHOUT WARRANTY. THERE IS NO
  68. WARRANTY FOR THE PROGRAM, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
  69. LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  70. PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. THE ENTIRE
  71. RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD
  72. THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
  73. SERVICING, REPAIR OR CORRECTION.
  74.  
  75.  
  76.  
  77. IF YOU DO NOT ACCEPT THIS LICENCE, YOU MUST DELETE ALL FILES CONTAINED IN
  78. THIS ARCHIVE.
  79.  
  80. _____________________________________________________________________________
  81.  
  82.  
  83. Installation:
  84.  
  85. The installation of PatchRAM is a bit more trickier than it used to be 
  86. because it is a permanent patch and replaces the code within the RAM
  87. handler directly.
  88.  
  89. 0) Unpack the archive to wherever you want. Open a shell and change
  90. the current directory to where the archive was unpacket.
  91.  
  92. 1) Extraction of the RAM-Handler: This step requires the Os 3.9 
  93. "AmigaOs ROM Update" file and the "ExtractModule" program in this
  94. distribution. Now enter on the command line:
  95.  
  96. version "DEVS:AmigaOs ROM Update"
  97.  
  98. 2) The output of this command should be "44.26" or the patch cannot be
  99. applied.
  100.  
  101.  
  102. 3) Enter the following command on the command line:
  103.  
  104. ExtractModule from "Devs:AmigaOS ROM Update" module 8 to ram:Ram-Handler
  105.  
  106. 4) This command will place the RAM-Handler within the ROM-Updates file to
  107. RAM:Ram-Handler. Now apply the patch to this file by entering the
  108. following command:
  109.  
  110. spatch -oram:Ram-Handler.new -pRam-Handler.pch RAM:Ram-Handler
  111.  
  112. 5) This command will generate the new RAM-Handler. Copy it now to "L:" by
  113. entering the following command:
  114.  
  115. copy ram:Ram-Handler.new to L:Ram-Handler
  116.  
  117. 6) You have now two alternatives how to make use of the new Ram-Handler. As
  118. it is no longer part of the ROM-Updates file, it has to enter the system in
  119. a different way. Alternative I) is to use the "LoadModule" command, 
  120. alternative II) is to mount it manually.
  121.  
  122.  
  123. Alternative I): This will make the new RAM-Handler reset-resident in much the
  124. same way as SetPatch did.
  125.  
  126. 7) Copy the LoadModule command from this archive to C:
  127.  
  128. copy LoadModule to C:
  129.  
  130. 8) Edit the startup-sequence with an editor of your choice. In the following,
  131. let's assume the default system editor, "Ed":
  132.  
  133. Ed S:Startup-Sequence
  134.  
  135. 9) Locate the "SetPatch" command within the startup-sequence, place the
  136. cursor on the "S" of "SetPatch" and press <RETURN>. This will insert a new
  137. blank line ON TOP of SetPatch. Move the cursor upwards into this blank
  138. line and enter the following command:
  139.  
  140. LoadModule L:Ram-Handler
  141.  
  142. 10) You may also load additional modules here, i.e. the Os 3.9 icon.library 
  143. or the Os 3.9 workbench.library. Just give their full paths as arguments to
  144. the LoadModule command. *NOTE THAT IT IS IMPORTANT THAT LOADMODULE IS RUN
  145. BEFORE SETPATCH*. With these modifications, the command line could look
  146. like this:
  147.  
  148. LoadModule L:Ram-Handler LIBS:icon.library LIBS:workbench.library
  149.  
  150.  
  151. The advantage of "LoadModule" is that the ROM modules loaded by
  152. this command can be protected from getting overwritten by means of 
  153. the "MuProtectModules" program of the same author (not included in this archive).
  154.  
  155. 11) Save the changes of the startup-sequence back. For "Ed", press first <ESC>,
  156. then <X>, then <RETURN>.
  157.  
  158. 12) To make the changes active, a reboot is *NOT* enough. You should turn
  159. off the machine, wait for half a minute, and reboot. This will flush the
  160. RAM resident parts of the ROM-Updates mechanism.
  161.  
  162.  
  163. Alternative II): Mounting the RAM-Handler by hand in a non-reset-resident
  164. way.
  165.  
  166. 7) Copy the the files "RAM" and "RAM.info" to DEVS:DosDrivers:
  167.  
  168. copy RAM RAM.info to DEVS:DosDrivers
  169.  
  170. 8) Edit the Startup-Sequence with an editor of your choice. For the following,
  171. let's assume you use the system editor "Ed":
  172.  
  173. ed S:Startup-Sequence
  174.  
  175. 9) Locate the "SetPatch" command within the startup-sequence. Move the cursor
  176. behind "SetPatch", and add the command line option "SKIPROMMODULES ram-handler"
  177. to the command. The setpatch command line should then read approximately as
  178. follows:
  179.  
  180. SetPatch SKIPROMMODULES ram-handler >NIL:
  181.  
  182.  
  183. If you already have to skip parts of the update, as for example the scsi.device,
  184. the line should rather look like this:
  185.  
  186. SetPatch SKIPROMMODULES "scsi.device ram-handler" >NIL:
  187.  
  188.  
  189. Note the double quotes!
  190.  
  191.  
  192. 10) Press <RETURN> and insert the following commands *BELOW* SetPatch, one in
  193. a line; note that it is important that these commands are run *AFTER* SetPatch
  194. (different from alternative I):
  195.  
  196. Assign RAM: DisMount
  197. Assign ENV: ENVARC:
  198. Mount DEVS:DosDrivers/RAM
  199. Assign ENV: Remove
  200.  
  201. 11) To save the changes back when using "Ed", press <ESC>, then <X>, then 
  202. <RETURN>. This step depends on the editor you use, though.
  203.  
  204. _____________________________________________________________________________
  205.  
  206.  
  207. For more information concerning "LoadModule", check "LoadModule.lha" on
  208. Aminet.
  209.  
  210. _____________________________________________________________________________
  211.  
  212.  
  213. April 2001,
  214.     Thomas
  215.  
  216.  
  217. ============================= Archive contents =============================
  218.  
  219. Original  Packed Ratio    Date     Time    Name
  220. -------- ------- ----- --------- --------  -------------
  221.     1560     991 36.4% 12-Apr-01 22:31:38 +ExtractModule
  222.     6360    4258 33.0% 12-Apr-01 22:31:44 +LoadModule
  223.     7420    3117 57.9% 13-Apr-01 15:28:30 +PatchRAM.readme
  224.      856     375 56.1% 25-Mar-98 19:25:40 +PatchRAM.readme.info
  225.       81      75  7.4% 12-Apr-01 22:32:14 +RAM
  226.      436     397  8.9% 12-Apr-01 22:31:16 +Ram-Handler.pch
  227.      471     256 45.6% 12-Apr-01 22:32:18 +RAM.info
  228.    14688    9310 36.6% 12-Apr-01 23:09:00 +spatch
  229. -------- ------- ----- --------- --------
  230.    31872   18779 41.0% 25-Apr-101 21:58:46   8 files
  231.